home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_elm.idb / usr / freeware / doc / elm / Alias.cat.z / Alias.cat
Encoding:
Text File  |  1998-10-28  |  15.3 KB  |  392 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                           TTTThhhheeee EEEEllllmmmm AAAAlllliiiiaaaassss SSSSyyyysssstttteeeemmmm UUUUsssseeeerrrrssss GGGGuuuuiiiiddddeeee
  20.  
  21.  
  22.  
  23.  
  24.                         _W_h_a_t _a_l_i_a_s_e_s _a_r_e _a_n_d _h_o_w _t_o _u_s_e _t_h_e_m
  25.                                _i_n _t_h_e EEEEllllmmmm _m_a_i_l _s_y_s_t_e_m
  26.  
  27.  
  28.  
  29.                                  The Elm Mail System
  30.                                     (Version 2.4)
  31.  
  32.  
  33.                            Syd Weinstein, Elm Coordinator
  34.                                Datacomp Systems, Inc.
  35.                                    3837 Byron Road
  36.                           Huntingdon Valley, PA 19006-2320
  37.  
  38.                           email: elm@DSI.COM  or  dsinc!elm
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                           Copyright 1986,1987 by Dave Taylor
  56.                   Copyright 1988-1992 by The USENET Community Trust
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                           TTTThhhheeee EEEEllllmmmm AAAAlllliiiiaaaassss SSSSyyyysssstttteeeemmmm UUUUsssseeeerrrrssss GGGGuuuuiiiiddddeeee
  79.  
  80.                          (The Elm Mail System, Version 2.4)
  81.  
  82.                                    October 1, 1992
  83.  
  84.  
  85.                                     Syd Weinstein
  86.                                Datacomp Systems, Inc.
  87.                                    3837 Byron Road
  88.                           Huntingdon Valley, PA 19006-2320
  89.  
  90.                           email: elm@DSI.COM  or  dsinc!elm
  91.  
  92.  
  93.                                     Derived from
  94.                          "The Elm Mail System, Version 2.0"
  95.                                          by
  96.                                      Dave Taylor
  97.                                   Intuitive Systems
  98.                               Mountain View, California
  99.                     email: taylor@intuitive.com  or  limbo!taylor
  100.  
  101.  
  102.  
  103.           This document is intended as a supplement to the _E_l_m _U_s_e_r_s  _G_u_i_d_e
  104.           and  is  only  of interest to those users desiring more knowledge
  105.           about how aliases work and how to  create  strange  and  exciting
  106.           aliases  for  their  systems (okay, so maybe it's not _t_h_a_t excit-
  107.           ing!)
  108.  
  109.           This document is broken up  into  the  following  sections;  user
  110.           aliases,  group  aliases,  system aliases, editing and installing
  111.           new aliases, general warnings and other chit-chat.
  112.  
  113.  
  114.  
  115.  
  116.           1111....  UUUUsssseeeerrrr AAAAlllliiiiaaaasssseeeessss
  117.  
  118.           The simplest type of aliases in the  Elm  system  are  individual
  119.           user aliases.  These are made up of three parts;
  120.  
  121.                   _a_l_i_a_s_n_a_m_e _l_i_s_t  =  _u_s_e_r_n_a_m_e  =  _a_d_d_r_e_s_s
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.           Alias Users Guide                                     Version 2.4
  129.  
  130.  
  131.  
  132.  
  133.  
  134.           Alias Users Guide                                     Version 2.4
  135.  
  136.  
  137.           Where the _a_l_i_a_s_n_a_m_e _l_i_s_t is either a single aliasname or a  list
  138.           of  aliasnames separated by commas.  Aliasnames are case insensi-
  139.           tive and will be converted to all lower case by the alias system.
  140.  
  141.           _U_s_e_r_n_a_m_e is used to indicate the full "real name"  of  the  user.
  142.           For  example,  if you had an alias for "taylor" to get to me, the
  143.           _u_s_e_r_n_a_m_e field would contain "Dave Taylor" or perhaps "Dave  Tay-
  144.           lor at HP" or some other permutation.  The name can optionally be
  145.           entered in the format of "Taylor; Dave".  When this is done,  the
  146.           alias  system can sort aliases on a last name basis for presenta-
  147.           tion on the alias menu within Elm.  Elm uses this information  to
  148.           add the user's full name to the addresses of outbound mail to get
  149.           more readable addresses.  No matter which format a  name  is  en-
  150.           tered,  Elm  displays  it and puts it in mail headers the way you
  151.           would expect (i.e., "Dave Taylor").
  152.  
  153.           _A_d_d_r_e_s_s is either the user's full electronic mail address or,  if
  154.           your  system  uses  a smart mailer, the minimum address needed to
  155.           specify the destination.  For example, say my smart  mailer  con-
  156.           tained information on how to get to machine "hp-sdd" and I wanted
  157.           to have an address for my friend Ken there - I could have his ad-
  158.           dress  specified  as  simply  "ken@hp-sdd" (or alternatively "hp-
  159.           sdd!ken" since the two are functionally equivalent).
  160.  
  161.           Let's get on to some examples, shall we?
  162.  
  163.           Consider this excerpt from my own ._e_l_m/_a_l_i_a_s_e_s._t_e_x_t file;
  164.  
  165.                # Mail aliases for Dave Taylor
  166.                # Friends from UCSD
  167.                addie          = Addie Silva    = addie@hp-sdd.SDD.HP.COM
  168.                frank,minjarez = Frank Minjarez = Minjarez.Verify@dockmaster.ddn.mil
  169.                pizzini        = Ken Pizzini    = hplabs!ucbvax!ucdavis!pai!ken
  170.                george         = Burdell; George P., Famous GT Guy= gburdell@matd.gatech.edu
  171.  
  172.           Note that the alias for Frank Minjarez has two _a_l_i_a_s_n_a_m_e_s associ-
  173.           ated with it, _f_r_a_n_k and _m_i_n_j_a_r_e_z.  Also notice that the first and
  174.           second aliases  use  the  Internet  style  naming  convention  of
  175.           _u_s_e_r@_m_a_c_h_i_n_e   whereas  the  third  uses  the  _u_u_c_p  notation  of
  176.           _m_a_c_h_i_n_e!_u_s_e_r.  The fourth alias illustrates two features for  the
  177.           _u_s_e_r_n_a_m_e  field.  An individual's name can be entered in the form
  178.           of _l_a_s_t_n_a_m_e; _f_i_r_s_t_n_a_m_e, _c_o_m_m_e_n_t which allows the alias system  to
  179.           be  able to sort alias names on a last name basis.  Additionally,
  180.           any text after the comma is treated as a comment.  It  is  stored
  181.           in  the  alias  file and displayed on the alias menu but will not
  182.           appear in the comment field  (between  the  parentheses)  in  the
  183.           header of a message.  This allows you to enter useful notes about
  184.           an individual that you would not otherwise want to include in the
  185.  
  186.           __________
  187.           1.  Aliasnames  can  be  any  combination  of  letters,
  188.           numbers,  hyphens  ('-'), periods ('.'), or underscores
  189.           ('_').   Letter  case  is  not  significant,  that  is,
  190.           "FRED", "Fred", and "fred" are identical.
  191.  
  192.  
  193.           October 1, 1992                                            Page 2
  194.  
  195.  
  196.  
  197.  
  198.  
  199.           Alias Users Guide                                     Version 2.4
  200.  
  201.  
  202.           TTTToooo:::: header of a mail message.
  203.  
  204.           For the most part, the notational format  is  transparent  within
  205.           the  alias  file  - the only time it _d_o_e_s make a difference is if
  206.           you have to specify more than the machine that the  user  is  re-
  207.           ceiving mail on (as in the third example above).
  208.  
  209.           Suffice to say that if you must specify any sort  of  uucp  route
  210.           that  you should use the uucp notation as much as possible to en-
  211.           sure that the system expands the correct machine name.   Similar-
  212.           ly,  if you're bouncing mail through different Internet sites (to
  213.           get to a foreign system, as in the example below) you should  use
  214.           the notation that system expects, e.g.:
  215.  
  216.                listserv%byuadmin.BITNET@rugters.edu
  217.  
  218.  
  219.           2222....  GGGGrrrroooouuuupppp AAAAlllliiiiaaaasssseeeessss
  220.  
  221.           After the confusion of user aliases, group aliases are even  more
  222.           fun!  For the most part the notation is very similar:
  223.  
  224.                _a_l_i_a_s_n_a_m_e _l_i_s_t   =   _g_r_o_u_p_n_a_m_e   =   _a_d_d_r_e_s_s _l_i_s_t
  225.  
  226.           Where _a_l_i_a_s_n_a_m_e _l_i_s_t and _g_r_o_u_p_n_a_m_e are exactly equivalent to  the
  227.           corresponding fields in user aliases.
  228.  
  229.           The interesting part is the _a_d_d_r_e_s_s _l_i_s_t field; this field is ac-
  230.           tually  in  the same notation as the aliasname list (i.e., a list
  231.           of addresses separated by commas), so it's really quite  easy  to
  232.           create.  It's best to illustrate by example:
  233.  
  234.                friends, mypals = The Gang of Six = joe, larry, mary, joanna,
  235.                                                    nancy, michael
  236.  
  237.           Notice that you can continue onto as many lines as you'd like  so
  238.           long  as  each  additional line starts with either a <_s_p_a_c_e> or a
  239.           <_t_a_b> character.
  240.  
  241.           At times it may be desirable to send a message to everyone in the
  242.           group  except one or two people.  This can be accomplished by ad-
  243.           ding the individuals' actual IDs to the TTTToooo:::: list, preceded  by  a
  244.           minus  sign  ('-').   For  example, if you were having a surprise
  245.           party for _n_a_n_c_y from the above group and you  wanted  to  discuss
  246.           the details with the others, you could mail the message to:
  247.  
  248.                friends -nancy
  249.  
  250.           Unlike in prior versions of Elm, group alias addresses  need  not
  251.           be  _p_r_e_v_i_o_u_s_l_y  _d_e_f_i_n_e_d  _a_l_i_a_s_e_s  or  valid mail addresses on the
  252.           current machine.  Any valid delivery address, local user, or pri-
  253.           or  user  or group alias may now be part of a group alias _a_d_d_r_e_s_s
  254.           _l_i_s_t.
  255.  
  256.  
  257.  
  258.           October 1, 1992                                            Page 3
  259.  
  260.  
  261.  
  262.  
  263.  
  264.           Alias Users Guide                                     Version 2.4
  265.  
  266.  
  267.           3333....  SSSSyyyysssstttteeeemmmm AAAAlllliiiiaaaasssseeeessss
  268.  
  269.           System aliases are functionally equivalent to the individual  Elm
  270.           alias  lists  each  Elm  user  has  (both  user aliases and group
  271.           aliases) but are _r_e_a_d _o_n_l_y for everyone but the  Elm  administra-
  272.           tor.   The  format  of the file is identical to the users' files,
  273.           and the only difference is that this file is expected to  be  lo-
  274.           cated  in  the  directory  that contains the ssssyyyysssstttteeeemmmm____hhhhaaaasssshhhh____ffffiiiilllleeee and
  275.           ssssyyyysssstttteeeemmmm____ddddaaaattttaaaa____ffffiiiilllleeee files (see the _E_l_m _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e for  more
  276.           details on these variables).
  277.  
  278.           Simply create the system alias file in the specified directory as
  279.           you  would a normal alias file, and install it using the newalias
  280.           command with the -g option (see the following  section  for  more
  281.           details on that).  Voila!!
  282.  
  283.  
  284.           4444....  EEEEddddiiiittttiiiinnnngggg aaaannnndddd IIIInnnnssssttttaaaalllllllliiiinnnngggg NNNNeeeewwww AAAAlllliiiiaaaasssseeeessss
  285.  
  286.           To install new aliases, you need merely to create, or modify, the
  287.           file  $_H_O_M_E/._e_l_m/_a_l_i_a_s_e_s._t_e_x_t  until you're satisfied with it and
  288.           it meets the requirements discussed above.  You can then  try  to
  289.           install it with the command:
  290.  
  291.                $ nnnneeeewwwwaaaalllliiiiaaaassss
  292.  
  293.           which either reports the number of aliases installed or  the  er-
  294.           rors encountered trying to parse and store the given alias list.
  295.  
  296.           Note that blank lines are no problem and that  comments  are  not
  297.           only  allowed  but  actually encouraged, and must have '#' as the
  298.           first character of each comment line.
  299.  
  300.  
  301.           5555....  OOOOtttthhhheeeerrrr SSSSttttuuuuffffffff nnnnooootttt CCCCoooovvvveeeerrrreeeedddd YYYYeeeetttt
  302.  
  303.           Probably the biggest question you have in your mind right now  is
  304.           "But  how  the heck does this relate to my existing _B_e_r_k_e_l_e_y _M_a_i_l
  305.           aliases and the lower-level _s_e_n_d_m_a_i_l alias system?"   Well,  rest
  306.           assured  that if you _r_e_a_l_l_y want to have your aliases down in the
  307.           transport you can.  No problem.
  308.  
  309.           And for those ex-_B_e_r_k_e_l_e_y  _M_a_i_l  fans,  you  can  translate  your
  310.           aliases  into  the  format that Elm wants by running them through
  311.           the _a_w_k script listed in the appendix.
  312.  
  313.           Finally, if you have any problems or questions,  try  looking  in
  314.           the _n_e_w_a_l_i_a_s manual entry.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.           October 1, 1992                                            Page 4
  324.  
  325.  
  326.  
  327.  
  328.  
  329.           Alias Users Guide                                     Version 2.4
  330.  
  331.  
  332.                                     AAAAppppppppeeeennnnddddiiiixxxx OOOOnnnneeee
  333.                         AAAAnnnn _a_w_k SSSSccccrrrriiiipppptttt ffffoooorrrr TTTTrrrraaaannnnssssllllaaaattttiiiinnnngggg AAAAlllliiiiaaaasssseeeessss
  334.                           ffffrrrroooommmm aaaa BBBBeeeerrrrkkkkeeeelllleeeeyyyy MMMMaaaaiiiillll ._m_a_i_l_r_c FFFFiiiilllleeee
  335.                           ttttoooo aaaannnn EEEEllllmmmm ._e_l_m/_a_l_i_a_s_e_s._t_e_x_t FFFFiiiilllleeee
  336.  
  337.  
  338.           BEGIN { print "# Elm .elm/aliases.text file, from a .mailrc file..."
  339.                print ""
  340.                }
  341.           next_line == 1 {
  342.                next_line = 0;
  343.                group = ""
  344.                for (i = 1; i <= NF; i++) {
  345.                  if (i == NF && $i == "\\") sep = ""
  346.                  else                       sep = ", "
  347.                  if ($i == "\\") {
  348.                    group = sprintf("%s,", group)
  349.                    next_line = 1;
  350.                  }
  351.                  else if (length(group) > 0)
  352.                    group = sprintf("%s%s%s", group, sep, $i);
  353.                  else
  354.                    group = $i;
  355.                  }
  356.                  print "\t" group
  357.                }
  358.           $1 ~ /[Aa]lias | [Gg]roup/ {
  359.                if ( NF == 3)
  360.                  print $2 " = user alias = " $3;
  361.                else {
  362.                  group = ""
  363.                  for (i = 3; i <= NF; i++) {
  364.                    if (i == NF && $i == "\\") sep = ""
  365.                    else        sep = ", "
  366.                    if ($i == "\\") {
  367.                      group = sprintf("%s,", group)
  368.                      next_line = 1;
  369.                    }
  370.                    else if (length(group) > 0)
  371.                      group = sprintf("%s%s%s", group, sep, $i);
  372.                    else
  373.                      group = $i;
  374.                    }
  375.                    print $2 " = group alias = " group;
  376.                  }
  377.                }
  378.  
  379.           Note:   this   script   is   contained   in   the   release    as
  380.           _u_t_i_l_s/_m_a_i_l_r_c._a_w_k.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.           October 1, 1992                                            Page 5
  389.  
  390.  
  391.  
  392.